Zum Hauptinhalt springen
Version: 5.1

TimePunch Authentication Service

TpAuthentication

Das Authentifizierungs-Objekt muss bei jeder Abfrage mitgesendet werden, bei der eine Authentifizierung des Benutzers notwendig ist. Dadurch wird sichergestellt, dass der Benutzer die erforderlichen Zugriffsrechte besitzt.

DatatypeNameDescription
StringCustomerTokenNot used at the moment.
StringTpUserTimePunch Profile of the used Principal
StringTpHashedPwdPassword Hash (build with MD5 Encryption)
StringIdentityProfile Name of the used Identity, or empty, if the identity is equal to the principal. In order to switch the identity, the principal needs administration rights.
StringCultureCulture that is used for the localization. e.g. "de-DE”

ValidatedAuthenticationDto : TpAuthentication

Diese Klasse wird bei der Anmeldung zurückgeliefert und enthält zusätzlich zu den übergebenen Daten der TpAuthentication Klasse, noch die Permissions und das gefüllte Customer Token.

DatatypeNameDescription
List\<String>ValidatedPermissionsPermissions of the logged on user.

UserProfileDto

Diese Klasse enthält die Basisdaten um ein TimePunch Profil zu identifizieren.

DatatypeNameDescription
GuidIdUnique ID of TimePunch Profile
StringSaveAsNameName of the TimePunch Profile used to show the user.
StringLogonNameBy default the logon name is identical to the used windows logon.
StringUserNameFirst name and last name of the user.
StringEmailEmail of the user

UserLogonDto : UserProfileDto

Diese Klasse enthält die Basisdaten von UserProfileDto und zusätzlich erweiterte Informationen um ein TimePunch Profil zu identifizieren.

DatatypeNameDescription
UserRightsRightsPermission of the user
DateTime?FirstEntryDate/Time of the first entry, if the user has an entry, otherwise NULL
DateTime?LastEntryDate/Time of the last entry, if the user has an entry, otherwise NULL
BoolIsUserProfileActiveTrue, if the user profile is active.
DateTime?LockedUpToDate until that the time entries are locked. NULL, if no time entries are locked at all.
BoolIsInCoverageTrue, if the user profile is in coverage

UserSearchDto : PagingContextDto

Diese Klasse enthält alle Basisdaten von PagingContextDto und definiert ein Filter zum Suchen von TimePunch Profilen.

DatatypeNameDescription
UserFilteringUserFilteringDefines if the users are filtered (CurrentUser, AllUser, SelfDefined)
Guid[]UserIdsIf Filter is set to "SelfDefined” than the users will be filtered by the given ids.
StringGenericSearchGeneric search string that search for logon and/or user name.
Bool?IsUserDeletedNULL, searches for deleted and active users. True, to search only for deleted users. False, to search only for non-deleted users.
Guid[]IsNotInGroupIdsList of group Ids where the user may not be a member of
Guid[]IsInGroupIdsList of group Ids where the user must be a member of
stringLogonNameSearches for the logon name
stringUserCodeSearches for the user code
BoolApplyUserCoverageApplies the coverage for the search

AutoregistrationDto

Diese Klasse enthält Informationen darüber, ob eine automatische Registrierung von neuen Mitarbeitern zulässig ist.

DatatypeNameDescription
BoolIsAutoregistrationAllowedDefines whether the auto-registration of new staff members is allowed.
UserRightsDefaultUserRightsGet the user rights of new staff members
BoolIsAutomaticLicensingDefines whether new members will get a new license. But only if there are licenses still available.